home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / PRG / Gestalt Selectors 3.3.sit / Gestalt Selectors 3.3 / Gestalt Selectors List 3.3 / Updates / Update 3.2.2 < prev    next >
Text File  |  1996-01-11  |  20KB  |  469 lines
  1.  
  2.  
  3. Happy New Year!
  4.  
  5. Hopefully 1996 with bring you what you expect.
  6.  
  7.  
  8. If you visited the GSL home Web pages recently you should have noticed
  9. version 3.2.1 was available instead of just 3.2. Whenever possible I try
  10. to make the latest 'bug fixes' available there from now on. But the HTML
  11. version may appear a few days after I emailed the update.
  12. Also, there are now more than 150 subscribers to the mailing list!
  13.  
  14. Included with this update is a note with the INITGestalt report. But I
  15. want to mention it here too:
  16.  
  17. ---------------------------------------------------------------------------
  18.  We, Jeremy Roussak and Rene Ros, will not work on new versions of this
  19.  proposed standard. Apart from not having the time to work on it we found
  20.  that it was not supported sufficiently by the programmers community.
  21.  Perhaps because it was not backwards compatible with existing software.
  22.  Also, we are worried by the yet unknown impact of memory protection of
  23.  Copland (System 8?) on the way of 'memory sharing' used by INITGestalt.
  24.  
  25. Our apologies for any inconvenience this decision may cause.
  26. ---------------------------------------------------------------------------
  27.  
  28. Best Regards,
  29. Rene
  30.  
  31.  
  32. Gestalt Selectors List 3.2.2 Update
  33. ===================================
  34.  
  35. Maintained by Rene G.A. Ros (rgaros@bio.vu.nl)
  36.  
  37. First published: 12 October 1992, 13:15 CET (GMT+1)
  38. Last version:    11 December 1995, 08:05 CET (GMT+1)
  39. Previous update: 18 December 1995, 07:40 CET (GMT+1)
  40. Last modified  : 11 January 1996, 01:40 CET (GMT+1)
  41.  
  42. The complete version is available to subscribers by sending an email to:
  43.      gestalt-selectors-list-request@bio.vu.nl
  44. with as subject:
  45.      archive get recent/gestalt-selectors.etx
  46. or to get the compressed version:
  47.      archive get recent/gestalt-selectors.sit.hqx
  48.  
  49. If this is the first update you receive since subscribing to the mailing
  50. list you may want to get the previous updates as well. Then email to the
  51. address listed above and use this command:
  52.      archive get updates/updates-comb.etx
  53.  
  54. A vertical bar in front of a line indicates the line has changed or was
  55. added.
  56.  
  57. PLEASE SEND COMMENTS AND CORRECTIONS TO THE EDITOR AS SOON AS POSSIBLE.
  58.  
  59. The following persons contributed to this update:
  60.  
  61. ===========================================================================
  62. Contributions to the selector sections
  63. ===========================================================================
  64. Person                 Software                Selector(s) added/changed
  65. ---------------------------------------------------------------------------
  66. Anonymous              Open Transport          otvr
  67. Jean-Pierre Curcio     AppleScript ext         ascv
  68.                        Speed Emulator ext      XAsm
  69.                        System?                 serh
  70.                        System                  snd 
  71. Avi Drissman           Conflict Catcher ext    cc20, cc30
  72. Andreas Magnusson      SLIP Extension          JMBe, SLP1
  73. Rene Ros               Extension AppleTel ext  apmo
  74.                        Stacker Removable Extension ext
  75.                                                SFM2
  76.                        System (enablers)       kbd 
  77. ---------------------------------------------------------------------------
  78.  
  79. ===========================================================================
  80. Contributions to the non-selector sections
  81. ===========================================================================
  82. Person                 Chapter/Section
  83. ---------------------------------------------------------------------------
  84. Jeremy Roussak / Rene Ros
  85.                        Reports/INITGestalt standard
  86. ---------------------------------------------------------------------------
  87.  
  88. Apple System Software (A-E)
  89. ===========================
  90.  ascv (AppleScript ext [1.0])
  91.       gestaltAppleScriptVersion &AS08
  92.       Returns the version of AppleScript as NumVersion?
  93.  
  94.       #define gestaltAppleScriptVersion 'ascv' /* AppleScript version */
  95.  
  96.       NOTE:
  97.       AppleScript 1.1 returns 0x01100110 which doesn't look like a proper
  98.       version number (version 1.0 returned 0x01008000). (Rene Ros)
  99. |     Perhaps the version of the Apple Event Manager in returned in the high
  100. |     word and the version of AppleScript in the low word? (Jean-Pierre
  101. |     Curcio)
  102.  
  103. Apple System Software (F-J)
  104. ===========================
  105. No changes.
  106.  
  107. Apple System Software (K-N)
  108. ===========================
  109.  kbd  (System [6.0.4])
  110.       gestaltKeyboardType
  111.       Returns a value that indicates the type of keyboard on which the last
  112.       keystroke was seen.
  113.  
  114.       enum {
  115.       #define gestaltKeyboardType 'kbd ' /* keyboard type */
  116.       gestaltMacKbd            =  1,  /* Macintosh Keyboard */
  117.       gestaltMacAndPad         =  2,  /* Macintosh Keyboard with Pad */
  118.       gestaltMacPlusKbd        =  3,  /* Macintosh Plus Keyboard */
  119.       gestaltExtADBKbd         =  4,  /* Extended ADB Keyboard */
  120.       gestaltStdADBKbd         =  5,  /* Standard ADB Keyboard */
  121.       gestaltPrtblADBKbd       =  6,  /* Portable ADB Keyboard */
  122.       gestaltPrtblISOKbd       =  7,  /* Portable ISO ADB Keyboard */
  123.       gestaltStdISOADBKbd      =  8,  /* Standard ISO ADB Keyboard */
  124.       gestaltExtISOADBKbd      =  9,  /* Extended ISO ADB Keyboard */
  125.       gestaltADBKbdII          = 10,  /* ADB Keyboard II */
  126.       gestaltElmerKbd          = 10,  /* = gestaltADBKbdII, used in some */
  127.                                       /*  sample code */
  128.       gestaltADBISOKbdII       = 11,  /* ISO ADB Keyboard II */
  129.       gestaltElmerISOKbd       = 11,  /* = gestaltADBISOKbdII, used in */
  130.                                       /*  some sample code */
  131.       gestaltPwrBookADBKbd     = 12,  /* PowerBook Keyboard &AT01 */
  132.       gestaltPwrBookISOADBKbd  = 13,  /* PowerBook Keyboard (ISO) &AT01 */
  133.       gestaltAppleAdjustKeypad = 14,  /* Apple Adjustable Keypad &AT01 */
  134.       gestaltAppleAdjustADBKbd = 15,  /* Apple Adjustable Keyboard, incl. */
  135.                                       /*  US, ISO and Japanese &AT01 */
  136.  
  137.       /* PowerBook Extended Keyboards &AS15 */
  138.       gestaltPwrBkExtISOKbd    = 20,  /* PowerBook Extended Intl. */
  139.       gestaltPwrBkExtJISKbd    = 21,  /* PowerBook Extended Japanese */
  140.       gestaltPwrBkExtADBKbd    = 24}; /* PowerBook Extended Domestic */
  141.  
  142.       ======================================================================
  143.       Combinations of System Global KbdType/ADB Mgr devType and
  144.       gestaltKeyboardType values                                       &AT01
  145.       ======================================================================
  146.       KbdType    gestaltKeyboardType     Gestalt Name
  147.       (hex.)     (decimal)
  148.       ----------------------------------------------------------------------
  149.        0x03          1                   gestaltMacKbd
  150.        0x13          2                   gestaltMacAndPad
  151.        0x0B          3                   gestaltMacPlusKbd
  152.        0x02          4                   gestaltExtADBKbd
  153.        0x01          5                   gestaltStdADBKbd
  154.        0x06          6                   gestaltPrtblADBKbd
  155.        0x07          7                   gestaltPrtblISOKbd
  156.        0x04          8                   gestaltStdISOADBKbd
  157.        0x05          9                   gestaltExtISOADBKbd
  158.        0x08         10                   gestaltADBKbdII
  159.        0x09         11                   gestaltADBISOKbdII
  160.        0x0C         12                   gestaltPwrBookADBKbd
  161.        0x0D         13                   gestaltPwrBookISOADBKbd
  162.        0x0E         14                   gestaltAppleAdjustKeypad
  163.        0x10         15                   gestaltAppleAdjustADBKbd, US
  164.        0x11         15                   gestaltAppleAdjustADBKbd, ISO
  165.        0x12         15                   gestaltAppleAdjustADBKbd, Japanese
  166.        0x13         20                   gestaltPwrBkExtISOKbd ?
  167.        0x14         21                   gestaltPwrBkExtJISKbd ?
  168.        0x17         24                   gestaltPwrBkExtADBKbd ?
  169.       ----------------------------------------------------------------------
  170.  
  171.       NOTES:
  172.       The Apple Adjustable Keyboard doesn't have its own Gestalt keyboard
  173.       type defined with some versions of System Software (7.1?). It changes
  174.       a low memory global but this doesn't change the Gestalt response. This
  175.       problem is corrected by the Hardware System Update 2.0 and later.
  176.  
  177.       If the keyboard isn't recognized by the Gestalt Mgr, an error is
  178.       returned. &AD19
  179.  
  180.       The PowerMac 7100/66 (System 7.1.2) doesn't install this selector for
  181.       some reason. Other Macs with Gestalt version 4 do, so it isn't
  182.       intentional.
  183.  
  184. |     You may find a Gestalt header file which lists the Extended ADB
  185. |     keyboard as three different types (Domestic, International and
  186. |     Japanese) instead of one as later was corrected by Apple in a
  187. |     Technical Note. Even the Gestalt header file for ETO #18 lists the
  188. |     old (?) info, but should I start doubting about the correctness of the
  189. |     Technical Note?
  190. |     The KbdType numbers for the PowerBook Extended Keyboards were found
  191. |     with the PTCH 5 resource of the Hardware System Update 2.0.
  192. |     (Rene Ros)
  193.  
  194.       Since this selector returns the type of the keyboard last touched
  195.       and because there can be more than one keyboard, MacDTS considers this
  196.       selector to be obsolete. You should use GetADBInfo instead and check
  197.       the orgADBAddr field for a keyboard (0x02) and the devType field
  198.       contains the keyboard device type. It uses the same values as the
  199.       KbdType low memory variable, see the table above. &AD07/AT01
  200.  
  201.  mach (System [6.0.4]) INF
  202.       gestaltMachineType
  203.       Returns one of the following values, indicating the type of
  204.       machine.
  205.  
  206.       enum {
  207.       #define gestaltMachineType 'mach' /* machine type */
  208.  
  209.       /* RELEASED COMPUTERS */
  210.       gestaltPowerMac8100_110    =  40, /* Power Macintosh 8100/110 and */
  211.                                         /*  Power Macintosh 8115/10 &AD18 */
  212. |     gestaltAWS8150_110         =  40, /* = gestaltPowerMac8100_110,
  213. |                                       /*  Workgroup Server 8150/110 */
  214. |                                       /*  &AS20 */
  215. |     gestaltAWS8150_80          =  65, /* = gestaltPowerMac8100_80,
  216. |                                       /*  Workgroup Server 8150/80 */
  217. |                                       /*  &AS20 */
  218. |     gestaltAWS6150_60          =  75, /* = gestaltPowerMac6100_60,
  219. |                                       /*  Workgroup Server 6150/60 */
  220. |                                       /*  &AS20 */
  221. |     gestaltAWS6150_66          = 100, /* = gestaltPowerMac6100_66,
  222. |                                       /*  Workgroup Server 6150/66 */
  223. |                                       /*  &AS20 */
  224.       };
  225.  
  226. [other values and notes are unchanged and omitted here]
  227.  
  228. Apple System Software (O-S)
  229. ===========================
  230.  snd  (System [6.0.4])
  231.       gestaltSoundAttr
  232.       Returns information about the sound capabilities of the machine.
  233.  
  234.       enum {
  235.       #define gestaltSoundAttr 'snd '   /* sound attributes */
  236.       gestaltStereoCapability    =  0,  /* can play stereo sounds */
  237.       gestaltStereoMixing        =  1,  /* mixes channels into single */
  238.                                         /*  signal */
  239. |     gestaltSoundReserved       =  2,  /* Sound Manager 3.1? QT uses new */
  240. |                                       /*  Sound Mgr calls? */
  241.       gestaltSoundIOMgrPresent   =  3,  /* new sound input routines avail.*/
  242.       gestaltBuiltInSoundInput   =  4,  /* built-in sound input device  */
  243.                                         /*  available */
  244.       gestaltHasSoundInputDevice =  5,  /* some sound input device avail. */
  245.       gestaltPlayAndRecord       =  6,  /* built-in hardware can play and */
  246.                                         /*  record simultaneously */
  247.                                         /*  &AS03/AS04 */
  248.       gestalt16BitSoundIO        =  7,  /* sound hardware can play and */
  249.                                         /*  record 16-bit samples &AS04 */
  250.       gestaltStereoInput         =  8,  /* sound hardware can record */
  251.                                         /*  stereo &AS04 */
  252.       gestaltLineLevelInput      =  9,  /* sound input port requires line */
  253.                                         /*  level &AS04 */
  254.       gestaltSndPlayDoubleBuffer = 10,  /* play from disk available &AS04 */
  255.       gestaltMultiChannels       = 11,  /* multiple channel support */
  256.                                         /*  &AS03/AS04 */
  257.       gestalt16BitAudioSupport   = 12}; /* 16 bit audio data supported */
  258.                                         /*  &AS04 */
  259.  
  260.       NOTES:
  261.       Bit 7 through 12 are not defined for versions of the Sound Manager
  262.       prior to version 3.0.
  263.  
  264.       With the Enhanced Sound Manager (version 2) you have both multi-
  265.       channel and play-from-disk capability if the Apple Sound Chip is
  266.       available. But the gestaltSndPlayDoubleBuffer and gestaltMultiChannels
  267.       bits are not set. Test for the gestaltHasASC bit of the
  268.       gestaltHardwareAttr selector. &AD06/AD20
  269.       A later Technical Note retracts this info, and says it is not safe to
  270.       assume both functions if the gestaltHasASC bit is set with the
  271.       gestaltHardwareAttr selector! &AT01
  272.  
  273. Apple System Software (T-Z)
  274. ===========================
  275. No changes.
  276.  
  277. Apple Additional Software
  278. =========================
  279. No changes.
  280.  
  281. Third Parties Software
  282. ======================
  283. |JMBe (SLIP Extension ? [???] part of MacSLIP by Hyde Park Software)
  284.       (Traceroute Ethernet LAP extension [1.0] by Jim Browne)
  285.       gestalt???
  286.       Returns the address of a structure as documented in the header file
  287.       'RawIP.h' to allow application programs to perform Raw IP writes and
  288.       filter all incoming IP packets.
  289.  
  290.       #define gestalt??? 'JMBe'
  291.  
  292. Unknown Gestalt Selector Codes
  293. ==============================
  294.  
  295. Apple Software
  296. --------------
  297. |apmo (Extension AppleTel ext [2.1.3?])
  298. |
  299. |     NOTE: Extension name translated from Dutch.
  300. |
  301. |otvr (Open Transport ??? [1.1?] part of System 7.5.3 / 7.5 Update 2.0s9)
  302.       gestaltOpenTransportVersion?
  303. |     Returns the version of Open Transport as NumVersion. (Anonymous)
  304.  
  305.       #define gestaltOpenTransportVersion? 'otvr'
  306.  
  307. |     NOTE: Observed value is 0x01106009 meaning 1.1b9.
  308.  
  309.  serh (System? [7.1.2?])
  310.       gestaltSerialHardware?
  311.       Returns type of hardware used for serial I/O?
  312.  
  313.       enum {
  314.       #define gestaltSerialHardware? 'serh' /* Serial Hardware */
  315.       gestaltClassicSer? = 'Clas',  /* returned on PM 8100/80 */
  316. |     gestalt???         = 'Impl',  /* returned on Quadra 660AV */
  317. |                                   /*  with System 7.5.1 */
  318.       gestalt???         = 'TntS'}; /* returned on PM 7200, */
  319.                                     /*  PM 8500 and PM 9500 */
  320.                                     /*  with System 7.5.2 */
  321.  
  322. Third Parties Software
  323. ----------------------
  324. |cc20 (Conflict Catcher ext [2.0?] by ???)
  325.       NOTE: The 'cc' are actually option-c (0x8D).
  326.  
  327. |cc30 (Conflict Catcher ext [3.0?] by ???)
  328. |     NOTE: The 'cc' are actually option-c (0x8D).
  329. |
  330. |SLP1 (SLIP Extension [???] part of MacSLIP by Hyde Park Software)
  331. |STM2 (Stacker Removable Extension ext [2.0?] by Stac Electronics)
  332. |XAsm (Speed Emulator ext [???] by Connectix Corporation)
  333.  
  334. Reports
  335. =======
  336.  
  337.  INITGestalt standard
  338.  --------------------
  339.  (by Rene Ros, based on INITGestalt proposal by Jeremy Roussak and Rene Ros)
  340.  
  341. |IMPORTANT NOTE:
  342. |We, Jeremy Roussak and Rene Ros, will not work on new versions of this
  343. |proposed standard. Apart from not having the time to work on it we found
  344. |that it was not supported sufficiently by the programmers community.
  345. |Perhaps because it was not backwards compatible with existing software.
  346. |Also, we are worried by the yet unknown impact of memory protection of
  347. |Copland (System 8?) on the way of 'memory sharing' used by INITGestalt.
  348.  
  349.  The INITGestalt proposal tried to define a standard memory structure which
  350.  describes the basic information about software. Using the Gestalt call
  351.  other software obtains a pointer to the structure for software which uses
  352.  the INITGestalt standard.
  353.  
  354.  You can obtain the latest, and last, version of the INITGestalt proposal by
  355.  sending an email, with subject 'archive get init-gestalt*', to
  356.       gestalt-selectors-list-request@bio.vu.nl
  357.  
  358. About this list
  359. ===============
  360. For this update this chapter only includes the 'Gestalt Submission Form',
  361. 'Acknowledgements' and 'Editors' Address' sections.
  362.  
  363. Gestalt Submission Form
  364. -----------------------
  365. You can use this form to report information you found on already included
  366. selectors. But you can also use it to register new Gestalt selector codes.
  367. If you want to register the selector code your software installs, make sure
  368. you registered your code first with Apple Computer, Inc. Also, it is your
  369. good right if you chose to keep the meaning of the response value private.
  370. If so, still register so that others can at least detect your software by
  371. determining if the selector is present.
  372.  
  373. Software means, in this form, the software which installs the selector
  374. code. Not the whole package, just the extension or control panel (perhaps
  375. application) itself.
  376. The package is the product name in which the software is included and
  377. distributed.
  378. If data is not available or relevant, leave it blank. When the selector
  379. contains non-ASCII characters, please also provide the hexadecimal value.
  380.  
  381. You can also fill in this form on-line because it is also on the WWW
  382. pages of the GSL: http://www.bio.vu.nl/home/rgaros/gestalt/
  383.  
  384.  
  385. Your name: 
  386.  
  387. Your email address: 
  388.  
  389. Your company name: 
  390.  
  391. Do you want to remain anonymous? Yes / No
  392.  
  393. Software name: 
  394.  
  395. Software type: O application 
  396.                O control panel
  397.                O extension (also 'appe')
  398.                O other:
  399.  
  400. Category:      O Apple System Software
  401.                O Apple Additional Software
  402.                O Apple Software
  403.                O Third Parties Software
  404.  
  405. Package name: 
  406.  
  407. Author or Company name: 
  408.  
  409. Gestalt Selector: 
  410.  
  411. Constant name: 
  412.  
  413. First version to install selector: 
  414.  
  415. Source of information: 
  416.  
  417. Short description of the returned response:
  418.  
  419.  
  420.  
  421.  
  422.  
  423. Additional constant names and values for the response value meaning:
  424.  
  425.  
  426.  
  427.  
  428.  
  429. Please email this form to this Internet address: rgaros@bio.vu.nl
  430.  
  431. Acknowledgements
  432. ----------------
  433. I want to thank the following persons for their contributions to this
  434. update and their support of this list:
  435.  
  436. ===========================================================================
  437. Name                                       Internet Email Address
  438. ---------------------------------------------------------------------------
  439. Anonymous contributor(s)                   anonymous@secret.bvd.nl
  440. Jean-Pierre Curcio                         JPC83@calvacom.fr
  441. Avi Drissman                               ad406@detroit.freenet.org
  442. Andreas Magnusson                      Andreas.Magnusson@mailbox.swipnet.se
  443. ---------------------------------------------------------------------------
  444.  
  445. Legal Stuff
  446. -----------
  447. (C) 1992-1996, Rene G.A. Ros
  448.  
  449. It is not allowed to distribute updates to the GSL. The full GSL can be
  450. used freely but is not public domain.
  451. See for legal information the Legal Stuff chapter of the full Gestalt
  452. Selectors List.
  453.  
  454. Editor's Address
  455. ----------------
  456. Rene G.A. Ros
  457. developer at Mac Support Automation B.V., Uitgeest, The Netherlands
  458. consultant to the Computer Department,
  459.     Biology Faculty, Vrije Universiteit Amsterdam, The Netherlands
  460. contract programmer Pascal and C, also 4th Dimension and other data-bases
  461.  
  462. D.C. van Krimpenstraat 3
  463. 1067 SG  Amsterdam-Geuzenveld
  464. The Netherlands, Europe
  465.  
  466. Email: rgaros@bio.vu.nl (preferred)
  467.        rgaros@dds.nl
  468.        100112.1363@compuserve.com
  469.